package com.horsen.service.edu.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.horsen.service.edu.model.BO.TeacherOutputBO;
import com.horsen.service.edu.model.DTO.TeacherInsertDTO;
import com.horsen.service.edu.model.DTO.TeacherUpdateDTO;
import com.horsen.service.edu.model.Teacher;
import com.horsen.service.edu.model.DTO.TeacherQueryDTO;

import java.util.List;
import java.util.Map;

/**
 * 讲师 服务类
 *
 * @author Horsen
 */
public interface TeacherService extends IService<Teacher> {

    /**
     * 分页查询
     *
     * @param page            当前页码
     * @param limit           每页记录数
     * @param teacherQueryDTO 讲师查询DTO
     * @return IPage类实例
     */
    IPage<Teacher> pageSelect(Long page, Long limit, TeacherQueryDTO teacherQueryDTO);

    /**
     * 新增一个讲师
     *
     * @param teacherInsertDTO 讲师插入DTO
     * @return 插入是否成功
     */
    Boolean insert(TeacherInsertDTO teacherInsertDTO);

    /**
     * 修改一个讲师
     *
     * @param teacherUpdateDTO 讲师更新DTO
     * @return 修改是否成功
     */
    Boolean updateById(TeacherUpdateDTO teacherUpdateDTO);

    /**
     * 根据姓氏获取讲师姓名列表
     *
     * @param key 姓氏
     * @return 讲师姓名列表
     */
    List<Map<String, Object>> queryNamesByKey(String key);

    /**
     * 根据讲师ID删除头像
     *
     * @param id 讲师ID
     * @return 是否删除成功
     */
    Boolean deleteAvatarById(String id);

    /**
     * 根据ID删除讲师
     *
     * @param id 讲师ID
     * @return 删除是否成功
     */
    Boolean deleteById(String id);

    /**
     * 导出讲师到Excel文件
     *
     * @param list 讲师列表
     * @return 文件位置
     */
    String output(List<TeacherOutputBO> list);

    /**
     * 根据讲师ID获取详情
     *
     * @param id 讲师ID
     * @return 详情Map
     */
    Map<String, Object> queryInfoById(String id);

}
